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Foreword 



rd , 



The present document has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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Scope 



The present document contains an electronic copy of the ANSI-C code for the eCall in-band modem solution for 
reliable transmission of MSD data from IVS to PSAP via the speech channel of cellular networks. The ANSI-C code is 
necessary for a bit exact implementation of the IVS modem and PSAP modem described in 3GPP TS 26.267 [1]. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 26.267: "eCall Data Transfer; In-band modem solution; General description". 

See also the references in 3GPP TS 26.267 [1]. 



3 Abbreviations 

For the purpose of the present document, the following abbreviations apply: 

ACK ACKnowledgement 

ANSI American National Standards Institute 

CRC Cyclic Redundancy Check 

FEC Forward Error Correction 

GSM Global System for Mobile communications 

HARQ Hybrid Automatic Repeat-reQuest 

I/O Input/Output 

IVS In-Vehicle System 

MSD Minimum Set of Data 

NACK Negative ACKnowledgement 

PCM Pulse Code Modulation 

PSAP Public Safety Answering Point 

RAM Random Access Memory 

ROM Read Only Memory 

RX Receive 

TX Transmit 



4 C code structure 

This clause gives an overview of the structure of the bit-exact C code and provides an overview of the contents and 
organization of the C code attached to the present document. 

The C code has been verified on the following systems: 

• Windows XP SP2 and Microsoft Visual Studio V8.0; 

• Linux (Suse Linux) using the gcc v3.4.2 and v4.L2 compilers. 
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4.1 



Contents of the C source code 



The distributed files with suffix "c" contain the source code and the files with suffix "h" are the header files. 
Further explanation on the files is given in the Readme . txt file, which is reproduced in part here: 

Package Contents 



folder ' ecall ' : 

Contains the complete eCall ANSI C fixed-point reference source code. 



modem_ivs . c 
modem_psap. c 

modemx . h 

ecall_def ines . h 

ecall_control . h 
ecall_f ec .h 
ecall_modem.h 
ecall_sync .h 
ecall rom.h 



top-level modem implementation for IVS 
top-level modem implementation for PSAP 

header file for both modem_ivs . c and modem_psap . c 

compile time options and preprocessor constants 

header file control message handling 
header file FEC encoder and decoder 
header file modulator and demodulator 
header file synchronization 
header file ROM data 



ecall_control . c 
ecall_f ec . c 
ecall_modem. c 
ecall_sync . c 
ecall rom.c 



control message handling 
FEC encoder and decoder 
modulator and demodulator 
synchronization 
ROM data 



folder ' test_setup ' : 

Contains the eCall software simulation framework, to be compiled 
and run on MS Windows systems . 

folder ' test_vec ' : 

Contains binary PCM data (104 files) and receiver/transmitter port logs 
in ASCII format (104 files) to test the eCall IVS and PSAP modems. 

The PCM format is 16 bit signed, little endian, at 8 kHz sampling rate. 
The data files reflect 26 test cases and were generated from the eCall 
simulation framework. 



campaign_short . txt 

pcmdlout<index> .pom 
pcmulout<index> .pom 

pcmdlin<index> .pcm 
pcmulin<index> .pcm 

portivsrx<index> . txt 
portivstx<index> . txt 



configuration file for the 26 test cases 



output PCM data of DL vocoder 
output PCM data of UL vocoder 



input to IVS 
input to PSAP 



test vectors for PSAP modem output 

test vectors for IVS modem output 

test vectors for IVS port logs (receiver) 

test vectors for IVS port logs (transmitter) 



portpsaprx<index> . txt : test vectors for PSAP port logs (receiver) 
portpsaptx<index> . txt : test vectors for PSAP port logs (transmitter) 

standalone . c 

mainO wrapper to run the IVS or PSAP modem on prestored PCM files or 
receiver/transmitter port logs. To get a list of command- line options, 
invoke the corresponding executable with option '-h' (help) . 

standalone .h 

header file for standalone. c 



Makefile .win 
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NMAKE Makefile for Microsoft Visual Studio 2005 and above: 
Builds 'standalone.exe' from standalone. c and the eCall sources, 
build options are RELEASE and DEBUG. 

Makefile .glx 

GNU Linux Makefile using gcc 

Builds 'standalone' from standalone. c and the eCall sources, 

build options are RELEASE and DEBUG. 

verify.bat 

Windows batch file 

Runs 'standalone.exe' in six different modem modes on the 26 test cases 
contained in folder ' test_vec ' and performs a test vector comparison to 
the respective output PCM and port log data. 

verify. sh 

Linux shell script 

Runs 'standalone' in mode ' -m ivs ' and ' -m psap ' on 26 test cases 
(folder 'pcm') and performs a test vector comparison to the respective 
modem output PCM data. 



4.2 Program execution 

An explanation on code compilation and execution is given in the readme . txt file, which is reproduced in part here: 

Getting Started 



3GPP TS 26.268 provides the eCall modem source code, a software simulation 
framework, and a standalone wrapper that allows to run the IVS or PSAP modem 
on prestored reference data. 

The following functions represent the eCall modem interface and invoke the 
respective receiver and transmitter implementation of each modem: 

* void IvsReset (const OrdS *msd, int length) ; 

* void IvsProcess (Intl6 *pcm) ; 

* void IvsSendStart (void) ; 

* void PsapReset (void) ; 

* void PsapProcess (Intl6 *pcm) ; 

* void PsapSendStart (void) ; 

* void PsapSendHlack (const OrdS data) ; 

The external application must in addition implement the callback functions: 

* void IvsCatchEvent (IvsEvent ie) ; 

* void IvsReceiveAck (void) ; 

* void IvsReceiveHlack (const OrdS data) ; 

* void PsapCatchEvent (PsapEvent pe) ; 

* void PsapReceiveMsd (const OrdS *msd, int length); 

* void Abort (const char * format, . . . ) ; 

* void Loglnfo (const char * format, . . . ) ; 

IvsCatchEvent and PsapCatchEvent inform about relevant modem events and can 
be used to perform actions such as muting or unmuting of the voice channel. 
The other callback functions indicate... 



* IvsReceiveAck 

* IvsReceiveHlack 

* PsapReceiveMsd 



reception of the lower-layer ACK, 
reception of the HLACK message, 
successful MSD reception. 
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Abort and Loglnfo should implement a variadic error and printlog handler, 
respectively. See standalone. c for sample implementations of all callback 
functions . 

For a real-time simulation over 3GPP FR and AMR vocoders and to log PCM data 

as input to the standalone wrapper, the eCall sources have to be integrated into a 

simulation framework; folder 'test_setup' contains the one as used in 

the 3GPP selection tests. 

In order to compile and run the eCall modem code, follow the instructions 
given below. For code testing, two batch files have been provided: 

* verify.bat : MS Windows systems 

* verify. sh : Linux systems 

For each of the 26 test cases of campaign_short.txt in folder ' test_vec ' , 
they run the standalone wrapper in six different modem modes (three IVS and 
three PSAP modes) . The resulting PCM and port log files in folder 'out' are 
finally compared to the test vectors in folder ' test_vec ' . 

In modes 'psap' and 'psaprx', you should see an MSD success message at the 
end of each test case. 

Code Compilation 



MS Windows systems 

Compilation assumes an installation of MS Visual Studio 2005 or above. 
To set the environment variables for building, run 'vcvars32.bat' which 
should be contained in the 'bin' subf older of your VC installation. 
To build standalone.exe from standalone. c and the eCall sources (or to 
perform cleanup) , run 

nmake /f Makefile. win 
nmake /f Makefile. win clean 

The source code should compile without any errors or warnings. 

Run 'verify.bat' to verify the executable against the test vectors. 



GNU Linux systems 

Compilation under Linux has been tested with 

* GNU Make version 3.81 

* gcc version 4.1.3 and 4.2.4 

For building the executable 'standalone' and cleanup, use 

make -f Makefile. glx 

make -f Makefile. glx clean 

On the platforms tested, the code compiled without errors or warnings. 
Run ' verify. sh' to verify the executable against the test vectors. 



Simulation Framework 



The eCall software simulation framework is provided in folder ' test_setup ' . 
Important remarks : 

* See LICENSE.TXT and README.TXT for terms of usage! 

* The G.711 software is part of ITU-T Rec . G.191, (C) ITU 2000. 
Distributed with the authorization of ITU as part of the test setup 
software for 3GPP TS 26.268. 

* The framework must be compiled and run on MS Windows systems, as the 
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FR and AMR vocoders are attached to it in form of Windows executables 
and via Windows specific API functions. 

To build (or clean) the framework together with the eCall IVS and PSAP, 
change to subf older 'c' of 'test_setup' and run (remember 'vcvars32.bat') 

nmake /f makef ile_ecall 
nmake /f makef ile_ecall clean 

The framework has the five callback functions of above already implemented. 
By default, the binaries (*.exe *.lib) are generated in the 'bin' subf older. 
You can use the following two batch files to run the executables: 



demosim.bat 
demosock.bat 



runs testsim_demo.exe 

runs testlab.exe and modem demo . exe in socket mode 



4.3 



Variables, constants and tables 



4.3.1 Description of constants used in the C-code 

This clause contains a listing of all global constants defined in ecall_def ines . h., together with some explanatory 
comments. 



Constant 



Value 



Description 



#define MAX(a,b) 
#define MIN(a,b) 
#def ine ABS (a) 
#define SIGN (a) 



(a)>(b) ? (a) 

(a)<(b) ? (a) 

(a)<0 ? (-a) 

(a)<0 ? (-1) 



(b) 
(b) 



#define PCM_LENGTH 
#define MSD_MAX_LENGTH 

/* Synchronization */ 
ttdefine SYNC_BADCHECK 
#define SYNC_BADTRACK 
#define SYNC_IDXLEN 
#define SYNC_THRESHOLD 

#define LOCK_RESYNC 
#define LOCK_START_UL 
#define LOCK_START_DL 

#define FAIL_RESTART 

#define NRF_WAKEUP 
#define NRF_SYNC 
#define NRF OBSERVE 



160 
140 



(3) 

(4) 

(75) 

(10e6) 

(2) 
(2) 
(3) 

(3) 

(3) 

(13) 
(10) 



length of PCM frame 

length of MSD message (bytes) 



sync consecutive bad check 
sync consecutive bad track 
sync index length 
sync threshold 

messages to lock after sync loss 
START messages to lock sync (UL) 
START messages to lock sync (DL) 

number of START messages to restart 

number of wakeup frames 
length of sync in frames 
number of sync observer frames 



#define NRF_RESYNC 
#define NRS_CP 
#define NRS_TRACK 
#define NRS CHECK 



(60) 
(2) 
(240) 
(480) 



resync frames after sync loss 
number of samples next to peaks 
number of samples to track 
number of samples to check 



#define PNSEQ_OSF 
#define PEAK_DIST_PP 
#define PEAK_DIST_NN 
#define PEAK_DIST_PN 

/* Uplink/Downlink format */ 
#define ARQ_MAX 
#define NRB_TAIL 
#define NRB CRC 



(22) "oversampling" rate of PN sequence 

(30*PNSEQ_OSF) distance outer positive peaks 

(54*PNSEQ_0SF) distance negative peaks 

(12*PNSEQ_0SF) distance positive to negative 



(8) 
(3) 

(28) 



number of redundancy versions 
number of encoder tail bits 
order of CRC polynomial 



#define NRB_INFO 
#define NRB INFO CRC 



( 8 *MSD_MAX_LENGTH) 
(8*MSD MAX LENGTH 



NRB CRC) 
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#define NRB_CODE_ARQ 
#define NRB CODE BUFFER 



(1380) 

(3*(8*MSD MAX LENGTH 



NRB CRC) + 4*NRB TAIL) 



#define SET_LLMSG 
#define SET_HLMSG 

#define NRF_DLDATA 
#define NRF_DLMUTE1LL 
#define NRF_DLMUTE1HL 
#define NRF DLCHUNK 



(16) set size lower-layer messages 

(16) set size higher-layer messages 

(3) downlink data frames 

(3) 1st muting lower- layer message 

(1) 1st muting higher-layer message 

(NRF SYNC + NRF DLMUTEIHL + 2*NRF DLDATA) 



/* IVS/PSAP processing */ 
#define NRF_MEMCTRL 
#define NRS MEMSYNC 



(7) 

(508 + 3 8*NRS CP) 



#define IVS_THRESHOLD 
#define IVS_GOSTART 
#define IVS_TXFAST 
#define IVS TXINC 



(40000) 
(6) 
(10) 
(87) 



threshold for control messages 
threshold for unreliable START 
fast modulator mode NACK condition 
sample increment at restart 



#define PSAP_NUMSTART 
ttdefine PSAP_NUMACK 
ttdefine PSAP_NUMHLACK 
#define PSAP_THRESHOLD 

#define FEC_VAR 
#define FEC_MEAN 
#define FEC_ITERATIONS 
#define FEC STATES 



(500) 
(5) 
(5) 
(40) 

(30206) 

(0xB9999A) 

(8) 

(8) 



number of START messages 
number of ACK messages 
number of PSAP HLACK messages 
threshold for modulator type 

variance: 1/4550000 in Q37 
mean: 5.8 in Q21 
number of decoder iterations 
number of decoder states 



#define IntLLR 
#define LLR_MAX 
#define LOGEXP_RES 
#define LOGEXP_DELTA 
#define LOGEXP QIN 



Intl6 size of soft bit buffer variables 

( (Int32) (0x7fff-l) ) 

(401) resolution of LOGEXP table 

(-6) determines internal Q-f actor 

(8) input Q-f actor of LLR values 



4.3.2 Type Definitions 



The following type definitions have been used, which are defined in ecall_defines.h, ecall_modem.h, ecall_sync.h, and 
modemx.h: 



Definition 



Description 



typedef enum 
typedef enum 



False, True } Bool; 

Minus = -1, 

Zero, 

Plus } Tern; 



boolean variable 



ternary variable 



typedef signed char Int8; 
typedef signed short int Intl6; 
typedef signed int Int32; 



8 bit signed variable 
16 bit signed variable 
32 bit signed variable 



typedef unsigned char Ordl; 

typedef unsigned char Ord8 ; 

typedef unsigned short int Ordl6; 

typedef unsigned int Ord32; 



binary symbol 
8 bit unsigned variable 
16 bit unsigned variable 
32 bit unsigned variable 



typedef enum { 
ModUndef , 
Mod3bit4smp, 
Mod3bit8smp 

} ModType ; 

typedef struct 
ModType type; 

Int 16 bpsym; 
Int 16 spmf; 
Intl6 mfpf; 



modulator type for uplink transmission 



identifies modulator type 

bits per symbol 

samples per modulation frame 

modulation frames per frame = PCM_LENGTH/spmf 
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Intl6 decposl; 

Intl6 decpos2 ; 

Intl6 wutperiod; 

Intl6 nfmutel; 

Intl6 nf mute4 ; 

Intl6 nfmuteall; 

Intl6 nfdata; 



position 1st decoding trial 

position 2nd decoding trial 

wakeup tone period in samples 

number of muting frames 1st interval 

number of muting frames 4th interval 

number of muting frames total 

number of data frames = NRB_CODE_ARQ/ (mfpf *bpsym) 



const Intl6 
const Intl6 
const Intl6 
const Intl6 
const Intl6 
ModState; 



*ulPulse; 
*ulPulseMatch; 
*mgTable; 
*wakeupSin; 
*wakeupCos ; 



modulator state for uplink transmission 



typedef struct { 
Int32 *mem; 
Int32 *memWakeup; 



/* memory for sync */ 

/* memory for wakeup tone detector */ 



SyncSub syncPos; 
SyncSub syncNeg; 



/* regular sync (non- inverted) */ 
/* inverted sync */ 



Int32 amplitude [3] ; 
Int32 shape [2*NRS_CP+1] 



/* amplitudes (average, maximum, memory) */ 
/* shape of peak causing a sync event */ 



Bool flag; 
Bool invert ; 
Bool resync; 



/* indicates sync success */ 
/* indicates sync inversion */ 
/* indicates resynchronization event */ 



Intl6 delay; 

Intl6 delayMem; 

Intl6 npeaks; 

Intl6 npeaksMem; 

Intl6 events; 



/* synchronization delay */ 

/* synchronization delay (memory) */ 

/* number of sync peaks detected */ 

/* number of sync peaks detected (memory) */ 

/* number of subsequent equal sync events */ 



Tern check; 
Intl6 checkCnt; 
Intl6 index; 
SyncState; 



/* indicates sync check result (ternary variable) */ 
/* counter for subsequent sync check failures */ 
/* frame reference for sync evaluation */ 



typedef struct { 

Int32 amplitude [2] ; 
Int32 shape [2*NRS_CP+1] 



/* amplitudes (average, maximum) */ 

/* shape of peak causing a sync event */ 



Bool flag; 
Intl6 delay; 
Intl6 npeaks; 
Intl6 npeaksChk; 
SyncSub; 



/* indicates sync success */ 

/* synchronization delay */ 

/* number of sync peaks detected */ 

/* number of sync peaks detected by sync check */ 



typedef enum 
DlMsgNoop = 
DlMsgReset , 
DlMsgStart, 
DlMsgNack, 
DlMsgAck, 
DlMsgHlack : 

} DlData; 



-2, 



SET LLMSG 



downlink message identifiers 



typedef enum 
DlCntStart 
DlCntWait, 
DlCntNext 

} Dl Count; 



-2, 



downlink message counter 



typedef enum { 
IVSEVENT_IDLE, 
I VSEVENT_SENDINGSTART , 
I VSEVENT_SENDINGMSD , 
I VSEVENT_RESTARTMSD , 
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IVSEVENT_CONTROLSYNC , 
IVSEVENT_CONTROLLOCK, 
IVSEVENT_LLACKRECEIVED , 
IVSEVENT_HLACKRECEIVED , 
IVSEVENT_TIMEOUT 
IvsEvent ; 



typedef enum 
Ivsldle, 
IvsTrigger , 
IvsStart , 
IvsSendMsd, 
IvsAck, 
IvsHlack 

} IvsState; 



IVS state identifiers 



typedef struct { 
IvsState state; 
CtrlRxData Ctrl; 
SyncState sync; 



IVS receiver state 
IVS control struct 
IVS sync struct 



Intl6 dlData; 
Intl6 dl Index; 
Intl6 dlMsgCnt; 

Intl6 memCtrl [NRF_MEMCTRL*PCM_LENGTH] 
Int32 memSync [NRS_MEMSYNC] ; 
} IvsRxData; 

typedef struct { 
IvsState state; 
CtrlTxData Ctrl; 
ModState mod; 
Intl6 delay; 
Intl6 rv; 
Intl6 ulN; 
Intl6 ul Index; 
Intl6 ulDelay; 
Intl6 dlMsgOld; 



downlink message symbol 
donwlink frame counter 
downlink message counter 



Bool pendingStart ; 
Intl6 overallNack; 



IVS transmitter state 

IVS control struct 

IVS modulator struct 

transmit offset in samples 

redundancy version 

uplink number of frames 

uplink frame counter 

uplink transmit offset in samples 

previous control message 



/* indicates pending START message */ 
/* cumulative NACK count */ 



Intl6 stateCnt [SET_LLMSG + 1] 
Intl6 stateIgn[SET_LLMSG + 1] 



state counters 

counter for unreliable messages 



Ordl memCode [NRB_CODE_BUFFER] ; 
Intl6 memDelay [2*PCM_LENGTH] ; 
IvsTxData; 



typedef struct ■ 
IvsRxData rx; 
IvsTxData tx; 

} IvsData; 



IVS receiver struct 
IVS transmitter struct 



typedef enum { 
PSAPEVENT_IDLE , 
PSAPEVENT_SENDINGSTART , 
PSAPEVENT_SENDINGRESTART , 
PSAPEVENT_SENDINGLLACK, 
P SAPE VENT_S END I NGHLACK , 
PSAPEVENT_CONTROLSYNC , 
PSAPEVENT_CONTROLLOCK, 
PSAPEVENT_MSDSYNC , 
PSAPEVENT_MSDRECEIVED, 
PSAPEVENT_TIMEOUT 

} PsapEvent; 

typedef enum { 
Psapldle, 
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PsapTrigger, 

PsapStart , 

PsapNack, 

PsapAck, 

PsapHlack, 

PsapState; 



PSAP state identifiers 



typedef struct { 
PsapState state; 
CtrlRxData Ctrl; 
SyncState sync; 
ModState mod; 



PSAP receiver state 
PSAP control struct 
PSAP sync struct 
PSAP modulator struct 



Intl6 rv; 

Intl6 ulN; 

Intl6 ul Index; 

Intl6 mglndex; 

Intl6 ulTrials; 

Intl6 ulSyncTail; 



redundancy version 

uplink number of frames without muting 

uplink frame counter 

uplink position in muting gap table 

uplink decoding trails 

sync observation counter after sync success 



OrdS dlHlackData; 
Intl6 dlData; 
Intl6 dl Index; 
Intl6 dlMsgCnt; 



downlink higher- layer message 
downlink message symbol 
donwlink frame counter 
downlink message counter 



(4 bits) 



OrdS *msd; 
Ordl *msdBin; 
Intl6 *memCtrl; 
IntLLR *memCode; 



MSD in byte representation 

MSD in binary representation 

buffer for control and data demodulation 

soft bit buffer for decoding 



char buffer [0 

+ sizeof (IntLLR) 
+ sizeof (Intl5) 
+ sizeof (Int32) 
+ sizeof (Int32) 

PsapRxData; 



NRB_CODE_ARQ 

NRF_MEMCTRL* PCM_LENGTH 

NRS_MEMSYNC 

2* (NRF SYNC+1) ] ; 



typedef struct { 

CtrlTxData Ctrl; 
} PsapTxData; 



PSAP control struct 



typedef struct { 
PsapRxData rx; 
PsapTxData tx; 
Intl6 msgCounter; 

} PsapData; 



PSAP receiver struct 
PSAP transmitter struct 
message counter 



typedef enum 
CtrlRxIdle, 
CtrlRxSync, 
CtrlRxLock, 
CtrlTxIdle, 
CtrlTxSend 

} PortState; 



typedef struct { 
PortState state; 
Bool invert ; 
union { 

CtrlTxPort tx; 
CtrlRxPort rx; 
} u; 

const char * owner; 
} CtrlPort; 



port state 

port inversion flag 

port control transmitter 
port control receiver 

port owner identification 



typedef struct { 
Intl6 dlData ; 
Intl6 dl Index; 

} CtrlTxPort; 



message symbol 
message frame counter 
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typedef struct { 
Intl6 dlData; 
Intl6 dlMetric; 

} CtrlRxPort; 



detected message symbol 
receiver metric 



typedef struct | 
CtrlPort port; 
} CtrlTxData; 



port struct 



typedef struct { 
CtrlPort port ; 

SyncState *sync; 
Intl6 *buffer; 

OrdS dlHlackData; 
Tern dlRead; 
Intl6 dl Index; 
Intl6 dlSyncLock; 
} CtrlRxData; 



port struct 

pointer to sync struct 

pointer to control receiver buffer 

downlink higher-layer message (4 bits) 
sync indication (ternary variable) 
internal frame counter 
number of sync events required 



4.3.3 Description of fixed tables used in tine C-code 

This clause contains a listing of all fixed tables (ROM) defined in ecall_rom . c. 

Type/Constant Dimension Description 

/* Synchronization */ 



const Intl6 wakeupSinSOO [16] 

const Intl6 wakeupCosSOO [16] 

const Intl6 wakeupSinSOO [10] 

const Intl6 wakeupCosSOO [10] 

const Intl6 syncPulseForm [5] 

const Intl6 syncSequence [15] 

const Intl6 syncIndexPreamble [SYNC_IDXLEN] 

const Intl6 syncFrame [10*PCM_LENGTH] 

/* Uplink/Downlink format */ 
const Intl6 indexBits [24] 

// fast modulator mode: 

const Intl6 m4smp_ul Pulse [16] 

const Intl6 m4smp_ulPulseMatch 

waveform 

const Intl6 m4smp_mgTable [66] 

// robust modulator mode: 

const Intl6 mSsmp_ulPulse [32] 

const Intl6 mSsmp_ulPulseMatch 

waveform 

const Intl6 mSsmp_mgTable [116] 



const Intl6 dlPcmData 

const Intl6 dlPcmDataMatch 

/* FEC encoder/decoder */ 

const Ordl6 stateTransMat 

const Ordl6 stateTrans 

const Ordl6 revStateTransMat 

const Ordl6 revStateTrans 

const Ordl outputParityMat 

const Ordl outputParity 

const Ordl crcPolynomial 

const Ordl scramblingSeq 

const Ordl6 interleaverSeq 

const Ordl6 redVerlndex 



[4] [NRF_DLDATA*PCM_LENGTH] 
[4] [NRF DLDATA*PCM LENGTH] 



sine waveform at 500 Hz 
cosine waveform at 500 Hz 
sine waveform at 800 Hz 
cosine waveform at 800 Hz 

sync pulse 

sync pulse sequence 

sync pulse positions 

predefined synchronization signal 



bit positions for turbo decoder 



uplink waveform 
[64] matched filtered uplink 

table indicating muting gaps 



uplink waveform 
[128] matched filtered uplink 

table indicating muting gaps 

downlink transmit signal 
DL MF signal 



[S] [2] 
[16] 
[S] [2] 
[16] 
[S] [2] 
[16] 

[NRB_CRC+1] 
[NRB_INFO_CRC] 
[NRB_INFO_CRC] 
[S] [NRB_CODE_ARQ] 



FEC 
FEC 
FEC 
FEC 
FEC 
FEC 



State transitions 
state transitions 
reverse state transitions 
reverse state transitions 
output parity indicator 
output parity indicator 



coefficients of CRC polynomial 
bit scrambling sequence 
interleaver sequence 
index vector for HARQ process 
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const IntLLR logExpTable [LOGEXP_RES] lookup table (logExp function) 

4.3.4 Static variables used in tine C-code 

This clause contains a listing of static variables (RAM) defined in source files. 

Definition Description 

IvsData ivs IVS static memory 

PsapData psap PSAP static memory 

IntLLR chLLRbuf fer [NRB_CODE_BUFFER] soft bit buffer of turbo decoder 

4.4 Functions of tine C Code 

This clause contains the headers of the employed IVS and PSAP functions. They correspond to a large extent to the 
functional description of the IVS and PSAP provided in 3GPP TS 26.267 [1]. 

Figure 1 gives an overview of the most important functions and their hierarchical relation. 
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IvsSendStart () 



IvsResetO : Rx and Tx 



CtrlTxReset ( ) 



Byte2Bit( ) 



FecEncode ( ) 



AttachCRCO 



Scramble ( ) 

EncodeTwoO 
EncodeOne ( ) 



IvsProcess() : Rx and Tx 

Ctrl Sync () 

- Sync ( ) 

- SyncCheckO 



IvsTXStateO 

- CtrlReceiver ( 

- SetiyiodState( ) 



IvsTransmitter ( ) 
SymbolModO 



PsapSendStart ( ) 



PsapResetO : Rx and Tx 

PsapProcess ( ) : Rx and Tx 
PsapRxO : UL and DL 



SyncO 
SetModState () 



Psap Receiver () 



Symbol Demod ( ) 
- JacLog ( ) 



FecDecode ( ) 



UpdateBuf f er i 



DecodeBuffer () 

- BcjrO 

- Interleave ( ) 

- Deinterleave ( ^ 



Descramble 



DecodeCRCO 



Bit2Byte () 



PsapReceiveMsd ( ) 



Psap Reset ( ) 




Figure 1: Hierarchical function overview 

4.4.1 Interface functions 

/* IVS implementation: IvsReset */ 

/* */ 

/* Description: Reset of IVS before the reception of a new MSD */ 

/* */ 

/* In: const OrdS* msd -> MSD to be transmitted */ 

/* int length -> MSD length (equal to MSD_MAX_LENGTH) */ 

/* */ 
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void IvsReset (const Ord8 *msd, int length) 

void IvsRxReset (void) 

void IvsTxReset (const OrdS *msd, int length) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* IVS implementation: IvsProcess */ 

/* */ 

/* Description: IVS modem function that processes the PCM data */ 

/* */ 

/* InOut : Intl6* pcm <-> input and output frame of 16bit PCM samples */ 
/* */ 

void IvsProcess (Intl6 *pcm) 

void IvsRxProcess (const Intl6 *pcm) 

void IvsTxProcess (Intl6 *pcm) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* IVS implementation: IvsSendStart */ 

/* */ 

/* Description: Initiates IVS to trigger the transmission of SEND messages */ 
/* */ 

void IvsSendStart (void) ; 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* IVS implementation: IvsReceiveAck */ 

/* */ 

/* Description: callback function indicating a received ACK message */ 

/* */ 

void IvsReceiveAck (void) ; 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* IVS implementation: IvsReceiveHlack */ 

/* */ 

/* Description: callback function indicating a received higher layer messages */ 
/* */ 

/* In: const OrdS data -> data symbol identifierer */ 

/* */ 

void IvsReceiveHlack (const OrdS data) ; 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* PSAP implementation: PsapSendStart */ 

/* */ 

/* Description: Initiates PSAP to trigger the transmission of an MSD */ 

/* */ 

void PsapSendStart (void) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* PSAP implementation: PsapSendHlack */ 

/* */ 

/* Description: Initiates PSAP to send the higher layer messages */ 

/* */ 

/* In: const OrdS data -> data symbol identifierer */ 

/* */ 

void PsapSendHlack (const OrdS data) ; 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

I* PSAP implementation: PsapReset */ 

/* */ 

/* Description: Reset of PSAP before the reception of a new MSD */ 

/* */ 

void PsapReset (void) 
void PsapRxReset (void) 
void PsapTxReset (void) 
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/* PSAP implementation: PsapProcess */ 

/* */ 

/* Description: PSAP modem function that processes the PCM data */ 

/* */ 

/* InOut : Intl6* pcm <-> input and output frame of 16bit PCM samples */ 

/* */ 

void PsapProcess (Intl6 *pcm) 

void PsapRxProcess (const Intl6 *pcm) 

void PsapTxProcess (Intl5 *pcm) 



4.4.2 IVS transmitter functions 

/* IVS FUNCTION: IvsTransmitter */ 

/* */ 

/* Description: IVS transmitter function */ 

/* */ 

/* In: const ModState* ms -> modulator struct */ 

/* const Ordl* buffer -> code bit buffer */ 

/* Intl6 rv -> redundancy version */ 

/* Intl6 index -> position within uplink frame */ 

/* Out: Intl6* pcm <- output data */ 

/* */ 

void IvsTransmitter (const ModState *ms, const Ordl *buffer, Intl6 *pcm, 

Intl6 rv, Intl6 index) 



/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* UTILITY FUNCTION: IvsTxState */ 

/* */ 

/* Description: IVS state machine evaluating feedback messages */ 

/* */ 

/* In: Intl6 msg -> new control message symbol */ 

/* Intl6 metric -> receiver metric (-1: ignore symbol) */ 

/* Bool syncLock -> indicates sync lock of control receiver */ 

/* */ 

void IvsTxState (Intl6 msg, Intl6 metric, Bool syncLock) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* IVS FUNCTION: SymbolMod */ 

/* */ 

/* Description: symbol modulator */ 

/* */ 

/* In: const ModState* ms -> modulator struct */ 

/* Intl6 symbol -> symbol index */ 

/* Out: Intl6* mPulse <- modulated output sequence */ 

/* */ 

void SymbolMod (const ModState *ms, Intl5 symbol, Intl5 *mPulse) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* IVS FUNCTION: Byte2Bit */ 

/* */ 

/* Description: conversion byte vector to bit vector */ 

/* */ 

/* In: OrdS* in -> vector of input bytes */ 

/* Intl6 length -> length of input */ 

/* Out: Ordl* out <- vector of output bits */ 

/* */ 

void Byte2Bit (const OrdS *in, Ordl *out, Intl6 length) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* ENCODER FUNCTION: FecEncode */ 
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/* */ 

/* Description: encoding of MSD */ 

/* */ 

/* InOut : Ordl *buffer <-> takes info bits and returns coded bits */ 

/* */ 

void FecEncode (Ordl *buf f er) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* ENCODER FUNCTION: AttachCrc */ 

/* */ 

/* Description: attaches CRC bits */ 

/* */ 

/* In: const Ordl* infoBits -> input information bits */ 

/* Out: Ordl* infoWithCrc <- bits with CRC attached */ 

/* */ 

void AttachCrc (const Ordl *infoBits, Ordl *inf oWithCrc) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* ENCODER FUNCTION: Scramble */ 

/* */ 

/* Description: bit scrambling */ 

/* */ 

/* In: const Ordl* in -> non scrambled input bit sequence */ 

/* Out: Ordl* out <- scrambled output bit sequence */ 

/* */ 

void Scramble (const Ordl *in, Ordl *out) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* ENCODER FUNCTION: EncodeTwo */ 

/* */ 

/* Description: encoding of bit sequence */ 

/* */ 

/* InOut : Ordl* codedBits <-> scrambled bits to coded bits */ 

/* */ 

void EncodeTwo (Ordl *codedBits) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* ENCODER FUNCTION: EncodeOne */ 

/* */ 

/* Description: convolutional encoding of each component */ 

/* */ 

/* In: Intl6 encNr -> component number */ 

/* InOut: Ordl* codedBits <-> bits to be encoded */ 

/* */ 

void EncodeOne (Ordl *codedBits, Intl6 encNr) 



4.4.3 PSAP receiver functions 

/* UTILITY FUNCTION: PsapRxUplink */ 

/* */ 

/* Description: PSAP UL state machine, determines PSAP receiver operation */ 
/* according to the state */ 

/* */ 

/* In: const Intl6* pcm -> input frame of 16bit PCM samples */ 

/* */ 

void PsapRxUplink (const Intl6 *pcm) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* UTILITY FUNCTION: PsapRxDownlink */ 

/* */ 

/* Description: PSAP DL state machine, determines PSAP transmitter operation */ 
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/* according to the state */ 
void PsapRxDownl ink (void) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* PSAP FUNCTION: PsapReceiver */ 

/* */ 

/* Description: PSAP receiver function (decoding is done outside) */ 

/* */ 

/* In: const ModState* ms -> modulator struct */ 

/* const Intl6* pern -> input data for demodulation */ 

/* Out: IntLLR* softBits <- demodulated soft bit sequence */ 

/* */ 

void PsapReceiver (const ModState *ms, const Intl6 *pcm, IntLLR *softBits) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* PSAP FUNCTION: SymbolDemod */ 

/* */ 

/* Description: symbol demodulator */ 

/* */ 

/* In: const ModState* ms -> modulator struct */ 

/* const Intl6* mPulse -> received pulse train */ 

/* Out: IntLLR* softBits <- demodulated soft bit sequence */ 

/* */ 

void SymbolDemod (const ModState *ms, const Intl6 *mPulse, IntLLR *softBits) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* PSAP FUNCTION: Bit2Byte */ 

/* */ 

/* Description: conversion bit vector to byte vector */ 

/* */ 

/* In: const Ordl* in -> vector of input bits */ 

/* Intl5 length -> length of output */ 

/* Out: OrdS* out <- vector of output bytes */ 

/* */ 

void Bit2Byte (const Ordl *in, OrdS *out, Intl6 length) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* PSAP FUNCTION: MpyLacc */ 

/* */ 

/* Description: multiply 32bit number with 16bit number (32bit result) */ 

/* */ 

/* In: Int32 var32 -> 32bit number */ 

/* Intl6 varl6 -> 16bit number */ 

/* Return: Int32 <- result */ 

/* */ 

Int32 MpyLacc (Int3 2 var32, Intl6 varl6) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* DECODER FUNCTION: FecDecode */ 

/* */ 

/* Description: decoding to find the MSD */ 

/* */ 

/* In: const IntLLR* in -> received soft bits */ 

/* Intl6 rv -> redundancy version */ 

/* Out: Ordl* out <- decoded MSD in binary representation */ 

/* Return: Bool <- result of CRC check */ 

/* */ 

Bool FecDecode (const IntLLR *in, Intl6 rv, Ordl *out) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

I* DECODER FUNCTION: UpdateBuffer */ 

/* */ 

/* Description: update channel LLR buffer with new soft bits */ 
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/* */ 

/* In: const IntLLR* softlnBits -> received soft bits */ 

/* Intl5 rv -> redundancy version */ 

/* InOut : IntLLR* chLLRbuffer <-> decoder buffer */ 

/* */ 

void UpdateBuffer (IntLLR *chLLRbuf f er, const IntLLR *softInBits, Intl6 rv) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

I* DECODER FUNCTION: DecodeBuffer */ 

/* */ 

/* Description: decoding of LLR buffer */ 

/* */ 

/* In: const IntLLR* systl - > RX systematic soft bits */ 

/* const IntLLR* syst2 -> interleaved RX systematic tail bits */ 

/* const IntLLR* parityl -> RX parity soft bits */ 

/* const IntLLR* parity2 -> interleaved RX parity soft bits */ 

/* Out: Ordl* decBits <- decoded bits */ 

/* */ 

void DecodeBuffer (const IntLLR *systl, const IntLLR *syst2, 

const IntLLR *parityl, const IntLLR *parity2 , Ordl *decBits) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* DECODER FUNCTION: Bcjr */ 

/* */ 

/* Description: BCJR algorithm */ 

/* */ 

/* In: const IntLLR* parity -> received parity soft bits */ 

/* InOut : IntLLR* extrinsic <-> extrinsic information */ 

/* */ 

void Bcjr (const IntLLR *parity, IntLLR *extrinsic) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* DECODER FUNCTION: Interleave */ 

/* */ 

/* Description: Turbo code interleaver */ 

/* */ 

/* In: const IntLLR* in -> input sequence */ 

/* Out: IntLLR* out <- output sequence */ 

/* */ 

void Interleave (const IntLLR *in, IntLLR *out) 
/*============================================================================*! 

I* DECODER FUNCTION: Deinterleave */ 

/* */ 

/* Description: Turbo code deinterleaver */ 

/* */ 

/* InOut: IntLLR* inout <-> input and deinterleaved output sequence */ 

/* */ 

void Deinterleave (IntLLR *inout) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* DECODER FUNCTION: Descramble */ 

/* */ 

/* Description: descrambles decoded bits */ 

/* */ 

/* InOut: Ordl* inout <-> input and output bit sequence */ 

/* */ 

void Descramble (Ordl *inout) 
/*============================================================================*! 

/* DECODER FUNCTION: DecodeCrc */ 

/* */ 

/* Description: check CRC of decoded bits */ 

/* */ 
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/* In: const Ordl* codedBits -> decoded bit sequence to be checked */ 
/* Return: Bool <- result of CRC check */ 

/* */ 

Bool DecodeCrc (const Ordl *codedBits) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

I* DECODER FUNCTION: GammaQ */ 

/* */ 

/* Description: compute gamma values for BCJR algorithm */ 

/* */ 

/* In: Intl6 k -> bit position */ 

/* Intl6 1 -> state */ 

/* const IntLLR* parity -> received parity bits */ 

/* const IntLLR* extrinsic -> sum of extrinsic and systematic bits */ 

/* Return: IntLLR <- value of gamma (k,l) */ 

/* */ 

IntLLR GammaQ (Intl6 k, Intl5 1, const IntLLR *parity, const IntLLR *extrinsic) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* UTILITY FUNCTION: JacLog */ 

/* */ 

/* Description: Jacobian logarithm */ 

/* */ 

/* In: IntLLR a -> value one */ 

/* IntLLR b -> value two */ 

/* Return: IntLLR <- Jacobian logarithm */ 

/* */ 

IntLLR JacLog (Int32 a, Int32 b) 



4.4.4 PSAP transmitter functions 

See control link functions. 

4.4.5 IVS receiver functions 

See control link functions. 

4.4.6 Syncinronization functions (IVS and PSAP) 

/* FUNCTION: Sync */ 

/* */ 

/* Description: main synchronization function */ 

/* */ 

/* InOut : SyncState* sync <-> sync struct */ 

/* In: const Intl6* pom -> input frame */ 

/* const char* caller -> modem identification */ 

/* Bool invert -> port inversion flag */ 

/* */ 

void Sync (SyncState *sync, const Intl5 *pcm, const char *caller, Bool invert) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* UTILITY FUNCTION: CtrlSync */ 

/* */ 

/* Description: control message sync function */ 

/* */ 

/* InOut : CtrlRxData* control <-> control struct */ 

/* In: const Intl6* pom -> input frame of 16bit PCM samples */ 

/* */ 

void CtrlSync (CtrlRxData *control, const Intl6 *pcm) 



£75/ 



3GPP TS 26.268 version 1 0.0.0 Release 1 23 ETSI TS 1 26 268 V1 0.0.0 (201 1 -04) 



/* UTILITY FUNCTION: SyncSubPut, SyncSubGet, SyncSubCpy */ 

/* */ 

/* InOut : SyncState* sync <-> sync struct */ 

/* InOut : SyncSub* ssub <-> sync subsystem */ 

/* */ 

void SyncSubPut (SyncState *sync, SyncSub *ssub) 
void SyncSubGet (SyncState *sync, SyncSub *ssub) 
void SyncSubCpy (const SyncSub *ssubln, SyncSub *ssubOut) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* UTILITY FUNCTION: SyncSubRun */ 

/* */ 

/* Description: sync peak evaluation */ 

/* */ 

/* InOut: SyncSub* ssub <-> sync subsystem */ 

/* In: const char* caller -> modem identification */ 

/* const Int32* pPos -> positive peaks positions */ 

/* const Int32* pCorr -> positive peaks correlation values */ 

/* const Int32* nPos -> negative peaks positions */ 

/* const Int32* nCorr -> negative peaks correlation values */ 

/* */ 

void SyncSubRun (SyncSub *ssub, const char *caller, 

const Int32 *pPos, const Int32 *pCorr, 
const Int32 *nPos, const Int32 *nCorr) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* IVS FUNCTION: SyncCheck */ 

/* */ 

/* Description: check whether locked sync is still valid */ 

/* */ 

/* InOut: SyncState* sync <-> sync struct */ 

/* In: const Intl6* pom -> input frame */ 

/* const char* caller -> modem identification */ 

/* */ 

void SyncCheck (SyncState *sync, const Intl6 *pcm, const char *caller) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* IVS FUNCTION: SyncTrack */ 

/* */ 

/* Description: uplink sync tracker */ 

/* */ 

/* InOut: SyncState* sync <-> sync struct */ 

/* In: Bool invert -> port inversion flag */ 

/* */ 

void SyncTrack (SyncState *sync, Bool invert) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* FUNCTION: SyncFilter */ 

/* */ 

/* Description: sync filter implementation */ 

/* */ 

/* InOut: SyncState* sync <-> sync struct */ 

/* In: const Intl6* pom -> input frame */ 

/* Bool invert -> port inversion flag */ 

/* */ 

void SyncFilter (SyncState *sync, const Intl6 *pcm, Bool invert) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 
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/* UTILITY FUNCTION: ToneDetect */ 

/* */ 

/* Description: tone detection at 500 Hz or 800 Hz */ 

/* */ 

/* InOut : SyncState* sync <-> sync struct */ 

/* In: const Intl6* pom -> input frame */ 

/* */ 

void ToneDetect (SyncState *sync, const Intl6 *pcm) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* UTILITY FUNCTION: PeakUpdate */ 

/* */ 

/* Description: update sync peak position */ 

/* */ 

/* In: const Int32* pos -> vector of positions */ 

/* const Int32* corr -> vector of correlation values */ 

/* Intl6 dist -> distance to be checked */ 

/* Return: Intl6 <- updated peak position */ 

/* */ 

Intl6 PeakUpdate (const Int32 *pos, const Int32 *corr, Intl6 dist) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* UTILITY FUNCTION: PeakCheck */ 

/* */ 

/* Description: check sync peaks */ 

/* */ 

/* InOut : SyncSub* ssub <-> sync subsystem */ 

/* In: const char* caller -> modem identification */ 

/* const Bool* pdet -> vector of peak detection flags */ 

/* const Intl6* p -> vector of frame numbers */ 

/* const Int32* corr (X) -> vector of correlation values */ 

/* Intl6 posl -> peak position 1 */ 

/* IntlS pos2 -> peak position 2 */ 

/* Intl5 npeaks -> number of detected peaks */ 

/* Intl6 delay -> target delay if sync successful */ 

/* */ 

void PeakCheck (SyncSub *ssub, 

const char *caller, const Bool *pdet, const Intl6 *p, 
const Int32 *corrP, const Int32 *corrN, const Int32 *corr, 
Intl6 posl, Intl6 pos2, Intl6 npeaks, Intl6 delay) 



/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* UTILITY FUNCTION: SyncReset */ 

/* */ 

/* InOut: SyncState* sync <-> sync struct */ 

/* In: Int3 2* mem -> pointer to sync memory */ 

/* Int3 2* memWakeup -> pointer to sync wakeup memory */ 

/* */ 

void SyncReset (SyncState *sync, Int32 *mem, Int32 *memWakeup) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* UTILITY FUNCTION: SyncSubReset */ 

/* */ 

/* InOut: SyncSub* ssub <-> sync subsystem */ 

/* */ 

void SyncSubReset (SyncSub *ssub) 



4.4.7 Control link functions 



I* UTILITY FUNCTION: CtrlPortName */ 
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/* */ 

/* Description: converter for log output */ 

/* */ 

/* In: PortOwner owner -> modem identification */ 

/* Return: const char* <- port name as character string */ 

/* */ 

const char* CtrlPortName (PortOwner owner) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* CONTROL FUNCTION: CtrlTxProcess */ 

/* */ 

/* Description: process function control transmitter */ 

/* */ 

/* InOut : CtrlTxData* control <-> control struct */ 

/* Intl6* pom <-> frame of 16bit PCM samples */ 

/* */ 

void CtrlTxProcess (CtrlTxData *control, Intl6 *pcm) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* UTILITY FUNCTION: CtrlTxMod */ 

/* */ 

/* Description: control message transmitter using prestored sequences */ 

/* */ 

/* In: Intl6 symbol -> lower-layer or higher-layer message symbol */ 

/* Intl6 index -> position within message frame */ 

/* Out: Intl6* pom <- output data */ 

/* */ 

void CtrlTxMod (Intl5 *pcm, Intl6 symbol, Intl6 index) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* CONTROL FUNCTION: CtrlRxProcess */ 

/* */ 

/* Description: process function control receiver */ 

/* */ 

/* InOut : CtrlRxData* control <-> control struct */ 

/* In: const Intl6* pom -> input frame of 16bit PCM samples */ 

/* */ 

void CtrlRxProcess (CtrlRxData *control, const Intl6 *pcm) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* UTILITY FUNCTION: CtrlRxDemod */ 

/* */ 

/* Description: control message receiver */ 

/* */ 

/* In: const Intl6* pom -> input PCM buffer */ 

/* Out: Intl6* metric <- reliability factor (-1: skip) */ 

/* Return: Intl6 <- demodulated message */ 

/* */ 

Intl6 CtrlRxDemod (const Intl6 *pcm, Intl6 *metric) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* CONTROL FUNCTION: CtrlTxReset */ 

/* */ 

/* Description: reset function control transmitter */ 

/* */ 

/* InOut: CtrlTxData* control <-> control struct */ 

/* In: const char* owner -> modem identification */ 

/* */ 

void CtrlTxReset (CtrlTxData *control, const char *owner) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* CONTROL FUNCTION: CtrlRxReset */ 

/* */ 
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/* Description: reset function control receiver */ 

/* */ 

/* InOut : CtrlRxData* control <-> control struct */ 

/* In: const char* owner -> modem identification */ 

/* SyncState* sync -> pointer to sync struct */ 

/* Intl6* buffer -> pointer to control receiver buffer */ 

/* IntlS syncLock -> number of sync events required */ 

/* */ 

void CtrlRxReset (CtrlRxData *control, const char *owner, 

SyncState *sync, Intl6 *buffer, Intl6 syncLock) 

4.4.8 Other utility functions (IVS and PSAP) 

/* UTILITY FUNCTION: SetModState */ 

/* */ 

/* Description: set the modulator state */ 

/* */ 

/* In: Intl6 modType -> type of modulator to use */ 

/* InOut : ModState* ms <-> modulator struct */ 

/* */ 

void SetModState (ModState *ms, ModType modType) 
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